home *** CD-ROM | disk | FTP | other *** search
/ Pascal Super Library / Pascal Super Library (CW International)(1997).bin / LIBRARY / OGRID110 / README.TXT < prev    next >
Text File  |  1995-06-01  |  9KB  |  218 lines
  1.  
  2.  
  3.                            OOGrid Library(TM) v1.1
  4.                    for Borland/Turbo Pascal (Real Mode/TV)
  5.                             Release date 06/01/95
  6.                                        
  7.                                        
  8.                            Copyright (C) 1994, 1995
  9.                               by Arturo J. Monge
  10.                                        
  11.                                        
  12.                        Portions Copyright (C) 1989,1990
  13.                         by Borland International, Inc.
  14.                                        
  15.                                        
  16.                                   README.TXT
  17.  
  18.  
  19. A. WHAT IS 'OOGrid Library (TM)'?
  20.  
  21.      OOGrid Library(TM) is a library of objects for Turbo Vision that
  22. provides a simple spreadsheet for use in your applications.  The spreadsheet
  23. in OOGrid Library(TM) can be used, for example, to manage lists, to browse
  24. and edit the data in a database, to create data entry screens or simply as an
  25. ordinary spreadsheet.  The library consists of one main object --
  26. TSpreadSheet -- and several auxiliary objects used by TSpreadSheet.  Some of
  27. these auxiliary objects (TLimScrollBar, TMessageLine, and TWindowList -- the
  28. latter implemented in the demo program) can be used by other objects or
  29. applications not related to OOGrid Library(TM).
  30.  
  31.      This library works with Turbo Pascal 6.0 and Borland/Turbo Pascal 7.0,
  32. and can be used to create real mode applications only; it does not work
  33. properly in protected mode applications.
  34.  
  35.  
  36. B. WHAT DOES 'OOGrid Library(TM)' DO?
  37.  
  38.      The spreadsheet object provided with OOGrid Library(TM) can handle text,
  39. values, formulas and repeat characters.  It supports several numerical
  40. functions (abs, trunc, round, exp, sin, cos, atan, sqr, sqrt, and ln) and
  41. operations (+, -, /, *, :, and ^) that can be used in formula or value cells. 
  42. It lets you mark, copy, move and erase blocks of cells, insert and delete
  43. columns and rows, change the width of a column or block of columns, and
  44. assign a custom header to any column in the spreadsheet. You can justify
  45. (left, center or right) the contents of a cell, and format numbers by adding
  46. commas, a currency character or by changing the number of decimals displayed. 
  47. There is also a sort function that lets you sort the rows of a block of cells
  48. using three different sort keys, in either ascending or descending order.
  49.  
  50.      The spreadsheet supports three modes of operation that you can toggle on
  51. and off independently: autocalc mode, in which all the formula cells are
  52. recalculated every time you add or modify a cell; display formulas mode, in
  53. which all formulas and not their results are displayed; and display headers
  54. mode, in which all custom assigned headers are displayed. There is also a
  55. spreadsheet protection feature, that lets you protect the data in the
  56. spreadsheet; when the spreadsheet is protected, only marked (unlocked) cells
  57. can be changed.  This feature is useful for creating data entry screens.
  58.  
  59.      The spreadsheet also offers several printing options.  You can print a
  60. file in normal or condensed mode and choose whether or not to print the
  61. column headers and/or the row numbers.  You can print row outlines and print
  62. the column headers and row numbers in bold characters, and also define the
  63. page layout (margins and number of columns and rows in a page).
  64.  
  65.  
  66. C. SOURCE CODE
  67.  
  68.      More than 100 pages of source code are included with OOGrid Library(TM). 
  69. The source code of GLCELL.PAS, GLLSTR.PAS, GLPARSER.PAS, TCHASH.PAS and
  70. TCUTIL.PAS are partially or completely copyrighted by Borland International,
  71. Inc. 
  72.  
  73.  
  74. D. LICENSE AGREEMENT
  75.  
  76.      You must read and accept the license agreement before using OOGrid
  77. Library(TM) for Borland/Turbo Pascal (Real Mode/TV).  See the file
  78. LICENSE.TXT. 
  79.  
  80.  
  81. E. DESCRIPTION OF FILES
  82.  
  83.      Before using OOGrid Library(TM) the first time, make sure you have all
  84. the following files;  if not, please contact the author immediately.
  85.  
  86.  Demo files:
  87.  
  88.      DEMOEQU.PAS    Equates unit for the demo program
  89.      DEMOMAKE.PAS   Program that creates the resource file used by the demo
  90.                     program
  91.      DEMO_GL.EXE    Demo program
  92.      DEMO_GL.PAS    Source code of the demo program
  93.  
  94.  Example files:
  95.  
  96.      EX_ENTRY.OGL   Two examples of data entry screens
  97.      EX_ERROR.OGL   Different errors reported by TSpreadSheet
  98.      EX_FUNCT.OGL   Different functions and operations supported by
  99.                     TSpreadSheet
  100.      EX_LICEN.OGL   License agreement.  MUST READ!
  101.      EX_LIST1.OGL   Some information about column headers and the sort
  102.                     function
  103.      EX_LIST2.OGL   An example list
  104.      EX_OOGL2.OGL   Information about next releases
  105.      EX_TYPES.OGL   Examples of the different types of cells supported by
  106.                     TSpreadSheet
  107.  
  108.  Source code files:
  109.  
  110.      GLEQUATE.PAS   Equates unit used by TSpreadSheet
  111.      GLSORT.PAS     Implementation of an object that can sort a cell hash
  112.                     table using three different keys
  113.      GLSUPPRT.PAS   Several support constants, variables, records and objects
  114.                     used by TSpreadSheet
  115.      GLTSHEET.PAS   This is the main unit, which implements the TSpreadSheet
  116.                     object
  117.      GLTVR_US.PAS   Implements two functions needed to create the resources
  118.                     used by TSpreadSheet (English)
  119.      GLTVR_SP.PAS   Implements two functions needed to create the resources
  120.                     used by TSpreadSheet (Spanish)
  121.      GLVIEWS.PAS    Implementation of several support views used by
  122.                     TSpreadSheet
  123.      GLWINDOW.PAS   Implementation of a TWindow's descendant that can own a
  124.                     TSpreadSheet object
  125.      GLCELL.PAS     Implementation of the different cell and hash table
  126.                     objects used by TSpreadSheet.
  127.      GLLSTR.PAS     Implementation of a long string object. 
  128.      GLPARSER.PAS   Implementation of the parser used by TSpreadSheet.  
  129.      GLBIULD.PAS    Used to build all the units in OOGrid Library(TM)
  130.      TCHASH.PAS     Implementation of the HashTable object
  131.      TCUTIL.PAS     Implementation of several support functions used by
  132.                     TSpreadSheet
  133.      TCCOMPAR.OBJ   Object code used by TCUTIL.PAS
  134.  
  135.  Text files:
  136.  
  137.      README.TXT     This file.
  138.      LICENSE.TXT    License agreement.  MUST READ!
  139.      NEXTRLSE.TXT   Information about future releases of OOGrid Library(TM)
  140.      MANUAL.TXT     Documentation of most of the units in OOGrid Library(TM)
  141.      REVISION.TXT   Changes made to OOGrid Library(TM) and its documentation
  142.      VENDORS.TXT    Information for vendors
  143.  
  144.  Utilities
  145.  
  146.      PRINTDOC.EXE   Use this program to print the documentation
  147.      PRINTDOC.PAS   Source code of the PRINTDOC.EXE program
  148.  
  149.  
  150. F. REQUIREMENTS
  151.  
  152.      Turbo Pascal 6.0 or Borland/Turbo Pascal 7.0
  153.      Turbo Vision 1.0 or Turbo Vision 2.0
  154.  
  155.  
  156. G. HOW TO USE 'OOGrid Library (TM)'
  157.  
  158.      There are several things that you must do before creating the first
  159. instance of a TSpreadSheet object in an application:
  160.  
  161.      1- Create a resource file, using the CreateOOGLDialogs and
  162.      CreateOOGLStrings functions in the GLTVR_US unit.
  163.  
  164.      2- Add new palette entries to the standard application palettes.
  165.  
  166.      3- Assign values to two pointer variables:
  167.  
  168.      a) GLResFile, which is a pointer to the resource file containing the
  169.      dialogs created using the CreateOOGLDialogs function (seeGLTVR_US.PAS). 
  170.      Remember to close and dispose the corresponding resource file before
  171.      terminating your application.
  172.  
  173.      b) GLStringList, which is a pointer to the string list created using the
  174.      CreateOOGLStrings function (see GLTVR_US.PAS).  Remember to dispose the
  175.      corresponding TStringList object before terminating your application.
  176.  
  177.  
  178.      The source code in DEMOMAKE.PAS and DEMO_GL.PAS shows you how to create
  179. the resource file needed by TSpreadSheet, extend the standard application
  180. palettes, initialize the GLResFile and GLStringList variables, and how to use
  181. a TSpreadSheetWindow and TSpreadSheet object in an application.
  182.  
  183.  
  184. H. ABOUT THE DOCUMENTATION
  185.  
  186.      The file MANUAL.TXT contains the documentation of OOGrid Library(TM).
  187. There is a short description of almost every unit in this library, and a
  188. description, in alphabetical order, of almost every variable, constant and
  189. type declared in those units.  Each description has an identifier
  190. declaration, the unit in which the identifier is declared, its function, its
  191. parameters' description (if any) and important remarks about the identifier
  192. (if any).
  193.  
  194.      The units GLPARSER.PAS, GLLSTR.PAS, TCHASH.PAS and TCUTIL.PAS are not
  195. documented.
  196.  
  197.  
  198. I. HOW TO CONTACT THE AUTHOR
  199.  
  200. You can contact the author at any of the addresses listed below:
  201.  
  202.  E-MAIL:
  203.       INTERNET:          mongev@ns.fing.ucr.ac.cr
  204.       CLEVELAND FREENET: fh441@freenet.cleveland.edu
  205.  
  206.  MAIL:
  207.       Arturo J. Monge
  208.       SJO 1684; POB 025216
  209.       Miami, FL 33102-5216
  210.  
  211. Sending correspondence via electronic mail is strongly preferred.
  212.  
  213. Please feel free to contact the author at any time to share your comments
  214. about this software and/or licensing policies, to ask questions about the use
  215. of this library and (please!) to report any bugs you may find.
  216.  
  217. Thanks a lot for your support!
  218.